home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 013 / arc_st.hlp < prev    next >
Encoding:
Text File  |  1986-10-05  |  6.8 KB  |  159 lines
  1. ARC Introduction and short docs.
  2.  
  3.  
  4.  
  5.           ARC (short for archive) is a file library and compression
  6.  
  7.           utility.  It may be thought of as an improved version
  8.  
  9.           of LU and SQUEEZE all rolled into one program.
  10.  
  11.  
  12.  
  13.           ARC analyzes each file to see which of a number of
  14.  
  15.           compression techniques will generate the smallest code.
  16.  
  17.           The following estimates give the user a general idea of
  18.  
  19.           how much compression may be gained by using ARC.
  20.  
  21.  
  22.  
  23.                 ARC Text -            45-55% reduction from original
  24.  
  25.                 SQUEEZED Text -       30-40% reduction
  26.  
  27.  
  28.  
  29.                 ARC Programs -        25-30% reduction
  30.  
  31.                 SQUEEZED Programs -   15-20% reduction
  32.  
  33.  
  34.  
  35.                 ARC Pictures -        45-55% reduction
  36.  
  37.                 SQUEEZED Pictures -   40-50% reduction
  38.  
  39.                 TINY Pictures -       40-50% reduction
  40.  
  41.  
  42.  
  43.           The user should see that compressing files with ARC
  44.  
  45.           will allow easier telecommunications by combining files
  46.  
  47.           and shortening their transfer time.
  48.  
  49.  
  50.  
  51.      Usage from TOS
  52.  
  53.           - double-click-left on ARC.TTP icon
  54.  
  55.           - observe OPEN APPLICATION menu for ARC.TTP parameters
  56.  
  57.           - enter switch, archive name and file template
  58.  
  59.             (ex: lh arc.arc *.*)
  60.  
  61.           - hit return or click-left on OK box to begin execution
  62.  
  63.           - "press any key to continue" after completion
  64.  
  65.  
  66.  
  67.      History
  68.  
  69.           ARC has been in use in the CP/M and MS-DOS world for many
  70.  
  71.           years.  Thom Henderson developed the version which I
  72.  
  73.           converted for use on the Atari ST.  I am not sure but he
  74.  
  75.           may also be the original author.
  76.  
  77.  
  78.  
  79.           It is important to note that no matter who developed this
  80.  
  81.           program, ARC is based on the file compression theories
  82.  
  83.           developed by Huffman, Welch, Knott, Knuth, and many other
  84.  
  85.           scientists.
  86.  
  87.  
  88.  
  89.      Bug Reports
  90.  
  91.           Since I developed this version of ARC, I will be responsible
  92.  
  93.           for any erroneous features.  Please relay any problems with
  94.  
  95.           a written discription of what happened and the .ARC file
  96.  
  97.           which caused the problem to:
  98.  
  99.  
  100.  
  101.                         Harvey Johnson
  102.  
  103.                         2398 Oaklyn St NE
  104.  
  105.                         Palm Bay, FL 32907
  106.  
  107.  
  108.  
  109.                              - or -
  110.  
  111.  
  112.  
  113.                       QUILL BBS 305-724-2303
  114.  
  115.  
  116.  
  117.  
  118.  
  119.      Future Products
  120.  
  121.           It would be nice to have a version of ARC written to utilize
  122.  
  123.           GEM.  I would also like to write a picture display feature
  124.  
  125.           that will show compressed pictures directly to the screen.
  126.  
  127.           This will be useful in that ARC squeezes file 5 to 10% smaller
  128.  
  129.           than TINY format.  If anyone has the C source to dump NEO,
  130.  
  131.           Degas, or other pictures to the screen please upload a copy
  132.  
  133.           to QUILL BBS.
  134.  
  135.  
  136.  
  137.           If you have any ideas for additional capabilities, then send
  138.  
  139.           them to me with a detailed explanation.  All thoughts are
  140.  
  141.           welcome.
  142.  
  143.  
  144.  
  145.      Donations
  146.  
  147.           It would be nice to be supported if you think that ARC
  148.  
  149.           is any good.  Make no mistake, I did NOT write the original
  150.  
  151.           version of ARC, but I have spent all my extra time for
  152.  
  153.           two months making it a reality on the Atari ST.
  154.  
  155.  
  156.  
  157.           As I do recieve contributions, I will consider improvements
  158.  
  159.           more seriously.  Any donations may be sent to address
  160.  
  161.           specified in Bug Report section.
  162.  
  163.  
  164.  
  165.           Thank you one and all in advance for considering this
  166.  
  167.           request, but if you are like me (lazy) then I don't
  168.  
  169.           really expect to ever see a single dime.
  170.  
  171.  
  172.  
  173. ARCHIVE (ARC.TTP)
  174.  
  175.  
  176.  
  177.      Usage
  178.  
  179.           arc {amdxelvth} <filename.ARC> [<filename> ...]
  180.  
  181.  
  182.  
  183.                a   = add files to archive
  184.  
  185.                m   = move files to archive
  186.  
  187.                d   = delete files in archive
  188.  
  189.                x,e = extract files from archive
  190.  
  191.                l   = list files in archive
  192.  
  193.                v   = verbose listing of files in archive
  194.  
  195.                t   = test archive integrity
  196.  
  197.                h   = hold screen before returning to Desktop
  198.  
  199.  
  200.  
  201.      Description
  202.  
  203.           This program is a general archive utility, and is
  204.  
  205.           used to maintain an archive of files.  An "archive"
  206.  
  207.           is a single file that combines many files, reducing
  208.  
  209.           storage space and allowing multiple files to be
  210.  
  211.           handled as one.
  212.  
  213.  
  214.  
  215.      Switches
  216.  
  217.  
  218.  
  219.           a - add files to archive.  This switch will force update
  220.  
  221.               or addition the indicated reguardless of creation
  222.  
  223.               time and date.
  224.  
  225.  
  226.  
  227.           m - move files to archive.  Same as "a" switch except
  228.  
  229.               that the files are deleted from the directory as
  230.  
  231.               they are moved to the archive.
  232.  
  233.  
  234.  
  235.           d - delete files in archive.  The files are lost forever
  236.  
  237.               and the archive is recompacted to remove the data
  238.  
  239.               for these files.
  240.  
  241.  
  242.  
  243.           x,e - extract files from archive.  A copy of the files
  244.  
  245.               in the archive are created in the current directory
  246.  
  247.               in an uncompacted state.
  248.  
  249.  
  250.  
  251.           l - list files in archive.  Limited information listing
  252.  
  253.               of files contained in an archive.  Displays only the
  254.  
  255.               filename.
  256.  
  257.  
  258.  
  259.           v - verbose listing of files in archive.  Complete
  260.  
  261.               information listing of files contained in an archive.
  262.  
  263.               Displays the filename, original length, storage method,
  264.  
  265.               storage factor (% savings), compacted size, date, time,
  266.  
  267.               and CRC.
  268.  
  269.  
  270.  
  271.           t - test archive integrity.  Check the archive to make sure
  272.  
  273.               it does not have any bad files contained.
  274.  
  275.  
  276.  
  277.           h - hold screen before returning to Desktop.  This switch
  278.  
  279.               should be used whenever ARC is executed from the
  280.  
  281.               Desktop, except in conjunction with file redirection.
  282.  
  283.  
  284.  
  285.      Examples when executed from GEM Desktop:
  286.  
  287.  
  288.  
  289.      ah FILES.ARC *.PRG      Creates a new archive file called FILES.ARC
  290.  
  291.                              and puts all files ending in .PRG inside.
  292.  
  293.  
  294.  
  295.      xh FILES.ARC *.*        Extracts all files from FILES.ARC.
  296.  
  297.      xh FILES.ARC            ""
  298.  
  299.      xh FILES                ""
  300.  
  301.  
  302.  
  303.      xh FILES.ARC *.DOC      Extracts all files ending in .DOC.
  304.  
  305.  
  306.  
  307.      In each case, the 'h' holds the display instead of immediately returning
  308.  
  309.      to the GEM Desktop so you can view filenames, messages, etc.  More
  310.  
  311.      complete docs are in the ARC.ARC archive file.  These are just to help
  312.  
  313.      you get started.  ARC seems to be the most reliable of the 'masher'
  314.  
  315.      programs and has the best overall size reduction.
  316.  
  317.